home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / music / pp13.zip / pp.doc < prev    next >
Text File  |  1993-02-11  |  13KB  |  273 lines
  1.        ▄▄▄▄▄                 ▄▄▄▄▄ ▄▄
  2.        ██  █ ▄▄▄▄▄ ▄▄    ▄ ▄▄▄▄▄ ▄▄▄▄ ██  █ ██  ▄▄▄▄▄ ▄▄  ▄ ▄▄▄▄▄ ▄▄▄▄
  3.        ███▄█ ██  █ ██ █ █ ██▄▄█ ██   ███▄█ ██  ▄▄▄██ ██  █ ██▄▄█ ██
  4.        ███   ███▄█ ████▄█ ███▄▄ ███  ███   ███ ███▄█ ███▄█ ███▄▄ ███
  5.                              ▄▄▄▄█
  6.  
  7.         --- When size & performance DO make a difference ---
  8.  
  9.  
  10.   FOREWORD:
  11.   ---------
  12.   As I'm not particularly interested in writing DOCs, I'll try to make this
  13.   a short one. I won't explain what these modules are, because I assume you
  14.   wouldn't have even downloaded this program if you didn't already know. :)
  15.   The player is made by the coders of THE ELECTROMOTIVE FORCE (EMF). Had to
  16.   mention that, too. ;-)
  17.  
  18.  
  19.   POWERPLAYER IN A NUTSHELL:
  20.   --------------------------
  21.   We decided that it was about time to release a MOD-player which plays the
  22.   modules exactly as they should be played.  We also think that most people
  23.   don't need scopes, equalizers and other fancy graphics on the screen when
  24.   playing modules - they just want to "play 'n' go!" ;-)  So we focused  on
  25.   finetuning the music routine itself to the extreme, and I sincerely think
  26.   that we  DID  succeed in that.  The player is very fast,  it eats up only
  27.   31 kilobytes of memory (plus the module, of course),    and what's the most
  28.   important thing - the modules  DO sound  just  like  they should.  I have
  29.   tested several module players with nearly  a thousand MOD and STM files -
  30.   PP seems to be the only one to play all of them correctly.
  31.  
  32.  
  33.   FUTURE PLANS:
  34.   -------------
  35.   We start working on Gravis Ultrasound support as soon as possible; we now
  36.   have some documents for it (thanks to Tran and CyberStrike of Renaissance
  37.   for releasing the information into Public Domain!),  and PP 2.0 will have
  38.   support for GUS!  Support  for new module formats (like ST3.0) might also
  39.   be added, given that they gain enough popularity...
  40.  
  41.  
  42.   HOW TO USE POWERPLAYER:
  43.   -----------------------
  44.   Using the  program is pretty simple  -  Just type in "PP filename", where
  45.   filename is the module you want to play. Quite simple and straighforward?
  46.   The player will start by searching the module from the current directory;
  47.   if it does not find it there, it will try the default module path,  which
  48.   can be specified in the configuration file. The default extension is MOD,
  49.   so you don't necessarily need to type  the extension at all.  PowerPlayer
  50.   uses Sound Blaster by default; if you want to use Covox or change playing
  51.   frequency or set the default module directories,  you must  either run PP
  52.   with the /C parameter or make the changes with your favorite ASCII editor
  53.   for example QEdit.
  54.  
  55.  
  56.   ADDITIONAL HINTS FOR USAGE:
  57.   ---------------------------
  58.   1) If you notice that some modules are playing  too slow or too fast, try
  59.      the /P override, which will disable ProTracker's extended tempos. Some
  60.      older NoiseTracker modules (e.g. klisje.mod)  may  use  speeds like 20
  61.      or 90,  even though  all speeds in the range of 20-FF are reserved for
  62.      extended BPM tempos in PT!  Naturally that  kind of modules will sound
  63.      wrong if they are played as Amiga's ProTracker would play them. That's
  64.      why we had to  include a switch for disabling the extended tempos. And
  65.      there's no way to detect if extended  tempos  should  or should not be
  66.      used; you have to decide it yourself. Fortunately non-standard modules
  67.      like Klisje.mod are quite rare and therefore you won't usually need to
  68.      bother with this option.
  69.  
  70.   2) If you have some modules  which are made on PCs  (the vast majority is
  71.      made on Amiga; say, 996 MODs out of 1000),  for example  with ModEdit,
  72.      you might want to experiment with the /O command line parameter.  This
  73.      option will force the player to  enable two extra octaves;  Amiga MODs
  74.      use only three octaves, whereas MODs made on PCs may use five. Usually
  75.      you won't hear any difference,  should  the module use five octaves or
  76.      not,  but if you notice some module playing  "out of tune",  try using
  77.      the /O override and see if it helps.
  78.  
  79.   3) SB Pro-users:  remember to turn on the SB Pro's filter using the "SBP-
  80.      SET" program. Otherwise the sound will be somewhat distorted.  This is
  81.      a known bug and will be fixed in the near future.
  82.  
  83.   4) Hint for 4DOS-users:   write the following lines in your AUTOEXEC.BAT:
  84.      (replace  "c:\bin\"  with the directory where your copy of PP resides)
  85.      SET .mod=c:\bin\pp.exe
  86.      SET .stm=c:\bin\pp.exe
  87.      SET .oct=c:\bin\pp.exe
  88.      SET .wow=c:\bin\pp.exe
  89.      Now, when you want to play a module,  you just  type  the    name of the
  90.      desired module,  and the music  will start!  Executable extensions are
  91.      really handy, aren't they? (Note: if you're NOT using 4DOS yet, go get
  92.      it somewhere immediately, because using a PC without 4DOS is PAIN!!!!)
  93.  
  94.   5) PowerPlayer is the most suitable choice for playing really big modules
  95.      which can't be loaded with other players.  First, PP requires far less
  96.      memory than other players;  second,  you can use VIDRAM.COM or similar
  97.      to get 96 kB more base RAM.  Most other players use VGA graphics,  and
  98.      therefore VIDRAM can't be used.  Some  users  have  noticed  that when
  99.      VIDRAM is loaded, the screen goes black when loading a module. Haven't
  100.      had time to  examine the problem,  but you  can  get  the text visible
  101.      again with the CLS command, so that's only a minor nuisance...
  102.  
  103.  
  104.   COMMAND LINE OPTIONS:
  105.   ---------------------
  106.   Usage: PP [-C] [-P] [-O] [-Sn] [-Dn] [-In] [-Mn] filename
  107.  
  108.      "Filename" is the module file to be played.
  109.  
  110.      -C lets you update the configuration file (PP.CFG).
  111.      -P disables the ProTracker's extended tempos (look above for more info).
  112.      -O forces the player to use 5-octave mode (look above for more info).
  113.      -Sn forces the player  to    use a certain mixing frequency, where n is
  114.          the frequency either in Hz or kHz (eg. -S16000 is the same as -S16).
  115.      -Dn forces the player to use a certain output device:
  116.  
  117.         -D1 = Use Sound Blaster
  118.         -D2 = Use Covox DAC on LPT1
  119.         -D3 = Use Covox DAC on LPT2
  120.  
  121.      -In forces the player to use a certain IRQ when playing with SB;
  122.  
  123.     -I2 = Use IRQ 2
  124.     -I3 = Use IRQ 3
  125.     -I5 = Use IRQ 5
  126.     -I7 = Use IRQ 7
  127.  
  128.      -Mn is the module    type override switch,  where n is the  number of the
  129.       desired module type. You should use this if the player fails to detect
  130.       the module's type.  Do not use this option unless you know what you're
  131.       doing.
  132.  
  133.     -M0 = STM (ScreamTracker 2.x)
  134.     -M1 = normal 4-channel .MOD file;
  135.     -M2 = MOD file with 15 instruments;
  136.     -M3 = An 8-channel WOW or OctaComposer module.
  137.  
  138.   NOTE: Both switch characters ('-' and '/') are accepted.
  139.     The options can be in any order, before or after the filename.
  140.  
  141.  
  142.   FEATURES OF PP (mainly for programmers and composers):
  143.   ------------------------------------------------------
  144.   Supports the following module formats:
  145.    o SoundTracker
  146.    o NoiseTracker
  147.    o StarTrekker
  148.    o ProTracker
  149.    o OctaComposer
  150.    o ScreamTracker (note: these are played in the same way as MODs!)
  151.    o 8-channel .WOW modules (converted from .669 format)
  152.    o 8-channel Fast Tracker modules
  153.    o ...and compatibles
  154.  
  155.   In addition, several features not so commonly
  156.   supported by PC module players are available:
  157.    o Modules with either 15 or 31 instruments
  158.    o Samples which are longer than 64 kB
  159.    o Modules with over 64 patterns (PT2.2 100-pattern mode)
  160.    o ProTracker's FineTune
  161.    o ProTracker's extended speeds (10-1F in vblanks, 20-FF in BPMs)
  162.    o Extended Vibrato & Tremolo waveforms
  163.    o All other extended commands of ProTracker, except FunkIt.
  164.    o A very fast & reliable DOS-shell (Note: COMSPEC must be set!)
  165.  
  166.   Music can be output via a Sound Blaster card or a DAC in the printer port
  167.   (either LPT1 or LPT2).  The player hasn't been tested with  Thunder Board
  168.   or Pro Audio Spectrum, but it should    work  on them.    If it doesn't, they
  169.   are not Sound Blaster compatible which is not our fault. :-)
  170.  
  171.  
  172.   LEGAL STUFF:
  173.   ------------
  174.   PP is copyright (c) 1993 by Tomi Aarnio, Teemu Valtonen and Petri Suni.
  175.  
  176.   PP is distributed  as Shareware,  meaning that you can use the player for
  177.   a trial period of FOUR WEEKS.  If you  continue to use it after that, you
  178.   should register it by paying $10 (50FIM) to the authors. Instructions for
  179.   registering  can be  found  at the end of this file.    Please    support the
  180.   Shareware concept!
  181.  
  182.   You can  distribute PP  in any way you wish,    for  example  via  BBSes or
  183.   various networks.  In fact, we strongly recommend you to copy the program
  184.   to all your friends,    neighbors and acquaintances,   as well as uploading
  185.   it to every BBS system you're visiting!
  186.  
  187.   DISCLAIMER:    The authors do not take any responsibility for the possible
  188.   (although highly unlikely)  damage or  data loss  caused  by the program.
  189.   You use PowerPlayer on your own responsibility.
  190.  
  191.  
  192.   CONTACTING THE AUTHORS:
  193.   -----------------------
  194.   If you have any comments,  bug  reports  or  ideas  on how to improve the
  195.   player,  you should  contact us immediately, and we will try to answer as
  196.   soon as possible.  I (Tomi Aarnio)  handle the "PR-stuff",  so you should
  197.   contact me in one of the following ways:
  198.  
  199.   mail:         | phone (voice only!): | BBS:
  200.   --------------+----------------------+-----------------------------------
  201.   Tomi Aarnio   | +358-(9)21-580 100   | +358-(9)21-827 419 / 8N1 / V.32bis
  202.   Seljatie 3 B  |                      | +358-(9)21-827 183 / 8N1 / V.32
  203.   SF-20900 Turku|                      | (24 hours a day, 7 days a week)
  204.   Finland       |                      | (DIANA available for Finns)
  205.   --------------+----------------------+-----------------------------------
  206.                                        | SBC-Net: 14:1510/400
  207.                                        | FidoNet: 2:222/151
  208.                                        +-----------------------------------
  209.  
  210.   Remember to call our distribution site, too:
  211.  
  212.   SB Center ---> +358-(9)42-14528 / 24h / V.32bis / SysOp: Kari Sorsimo
  213.  
  214.  
  215.   HOW TO REGISTER:
  216.   ----------------
  217.   The easiest way to pay the registration fee is to send the money ($10) to
  218.   my bank account using a bank giro (remember to state your address so that
  219.   we will know where to send the disk!):
  220.  
  221.         From Finland:        From abroad:
  222.  
  223.         TOP Turku        OKOBANK / Turku
  224.         571004-5480249        Finland
  225.                     571004-5480249
  226.  
  227.   We can not handle  VISA or any other credit cards,  but we will accept US
  228.   dollars and Finnish marks (and why not other currencies as well) sent via
  229.   mail. We prefer US dollars, but you can send the sum in your own currency
  230.   if you really want to. Just don't send any coins! Please allow  two weeks
  231.   at the maximum for delivery.    Remember  to  specify floppy disk type (3½"
  232.   1.44MB or 5¼" 1.2MB).
  233.  
  234.  
  235.   WHY TO REGISTER:
  236.   ----------------
  237.   1) You will get rid of the annoying beep and 4-sec delay when quitting,
  238.      and in addition to this you will save about 1000 bytes of memory.
  239.   2) You will receive the next upgrade of PowerPlayer FREE OF CHARGE,
  240.      and all the major upgrades after that for only $5 or 25 FIM!
  241.   3) You will support the Shareware concept  and encourage us to write more
  242.      fine utilities and other stuff.  And ten bucks isn't that much, is it?
  243.  
  244.   As the  PowerPlayer  doesn't require very  much  disk space the remaining
  245.   disk space can be filled with modules of your choice. Pick your favorites
  246.   from the  file  MODS.LST and we will    include those  modules on the disk.
  247.   All modules are purely in their original form;  no  conversions have been
  248.   made.  (Of course the modules will be  packed  so  that more modules will
  249.   fit on the disk.)  If you can't decide which    modules  you  would like to
  250.   have, we can make a collection of high quality modules for you!  The file
  251.   MODS.LST naturally includes only a  small fraction of my collections, but
  252.   I qualified only some of the best modules to the list.
  253.  
  254.   BTW, if you don't already have the demos & intros of our little demo team
  255.   (The Electromotive Force = EMF),  you might  want  us to  include them on
  256.   the disk as well:
  257.  
  258.   EMFINTRO.EXE --> Our first intro, released in October, 1991. Size: 70k.
  259.   DELIRIUM.EXE --> Intro/dentro coded in the spring of 1992, size: 116k.
  260.   EMF_ID.EXE   --> Our major product so far,  includes    six  parts and some
  261.            quite cool effects, fast code, nice gfx & sfx, yet takes
  262.            up only 150k of disk space!
  263.  
  264.   GREETINGS:
  265.   ----------
  266.   Greetings must go to all beta testers  who  helped us  getting the player
  267.   as bug-free as possible:  Jussi Heino, Jani Väisänen, Sami Virtanen, Jani
  268.   Lehmuskoski, Jani Mattsson and Esa Tuokko.  Quick group  greetings to the
  269.   following teams: Triton, Renaissance, The Future Crew, Cascada, Hysteria,
  270.   The Phoney Coders,  Surprise! Productions, Witan, Access Denied,  Epical,
  271.   Sonic PC, and every other group working on the PC scene!
  272.  
  273.